home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / UTILITY / MENUDLX / DOKUMENT / MENUDLX.INF < prev   
Encoding:
Text File  |  1991-11-02  |  15.8 KB  |  398 lines
  1. G F A  -  M e n u  -  D e l u x e    ----->   MENUDLX.PRG
  2. Das Info-File  MENUDLX.INF  (MENUDLX.DOC als Word-Plus-File)
  3. Th. Schaerer   Im Lindenhof 6   CH-8307 Effretikon (Schweiz)  
  4. ============================================================
  5.  
  6.  
  7.  
  8. Motivation.
  9. -----------
  10.  
  11. Mit  der Auslieferung des originalen Entwicklungspacketes  GFA-3.x-BASIC 
  12. der Firma GFA-Systemtechnik,  erhält man auf der Diskette "Compiler" ein 
  13. in   GFA-3.x-BASIC   geschriebenes   Menuprogramm   als    GFA-Quelltext 
  14. (MENUX.GFA) und als lauffähiges Programm (MENUX.PRG).  Leider ist dieses 
  15. Menu  für  die Steuerung des Interpreters und Compilers  derart  minimal 
  16. gestaltet,  dass etwas anspruchvollere GFA-3.x-BASIC-Programmierer genö-
  17. tigt sind,  dieses Menu den eigenen Bedürfnissen anzupassen und entspre-
  18. chend zu erweitern,  was nicht selten viel Zeit beansprucht, die man für 
  19. Produktiveres einsetzen könnte.
  20.  
  21. Dieser Mangel  führte dazu,  dass ich dieses MENUX.GFA im Laufe von etwa 
  22. 1½  Jahren  stetig etwas weiterentwickelt habe.  Meine Arbeit  soll  nun 
  23. dazu  dienen,  dass nicht jeder GFA-3.x-BASIC-Programmierer  den  Hammer 
  24. erneut erfinden muss.
  25.  
  26. Der   neue  Name  dieses  neuen  Menuprogrammes  ist  MENUDLX.GFA   bzw. 
  27. MENUDLX.PRG,  was eine Abkürzung des vollen Namen "GFA-MENU-DELUXE" ist. 
  28. Im Folgenden wird beschrieben was GFA-MENU-DELUXE besser und  zusätzlich 
  29. kann.
  30.  
  31.  
  32.  
  33. Die Gemeinsamkeit von MENUX und GFA-MENU-DELUXE.
  34. ------------------------------------------------
  35.  
  36. Da  GFA-MENU-DELUXE  (MENUDLX)  eine Weiterentwicklung  des  MENUX  ist, 
  37. gelten,  wenn  in diesem Readme nicht anders erläutert,  die sehr  knapp 
  38. gehaltenen Angaben der README.COM-Datei,  welche dem  GFA-3.x-BASIC-Ent-
  39. wicklungspacket  beiliegt.  Ebenfalls  gelten,  wenn hier  nicht  anders 
  40. erläutert,  die  Angaben  im Kapitel "Arbeiten mit der Shell"  des  Com-
  41. piler-Begleitbuches "GFA-BASIC 3.0"  von GFA-Systemtechnik GmbH  Düssel-
  42. dorf.  Besonders  erwähnenswert ist der Beitrag zum Compiler und  Linker 
  43. im Buch "Das grosse GFA-BASIC-3.5 Buch" von Litzendorf,  vertrieben  von 
  44. DATA-BECKER.
  45.  
  46.  
  47.  
  48. Rechtliche Situation.
  49. ---------------------
  50.  
  51. Da wie oben erwähnt,  mein GFA-MENU-DELUXE (MENUDLX.GFA) eine Weiterent-
  52. wicklung des MENUX.GFA von GFA-Systemtechnik ist,  fragte ich bei dieser 
  53. Firma nach,  ob es mir erlaubt ist, mein GFA-MENU-DELUXE zu veröffentli-
  54. chen.  In einem Brief vom 8.07.91 erhielt ich folgende Antwort:  "Da die 
  55. GFA-Systemtechnik auf keinerlei Programm Copyrightanspruch hat,  die mit 
  56. GFA-BASIC erstellt wurden,  steht einer Weitergabe Ihrer Shell nichts im 
  57. Wege."
  58.  
  59.  
  60.  
  61. Mein Angebot.
  62. -------------
  63.  
  64. Die  Benutzung  und  Verbreitung meines  GFA-MENU-DELUXE  inklusive  des 
  65. Quelltextes  ist  gratis.  Als Gegenleistung wünsche ich mir  Echos  von 
  66. Benutzern des GFA-MENU-DELUXE.  Es interessieren mich Kritik, Anregungen 
  67. und Ideen, auch solche welche von Benutzern implementiert wurden.
  68.  
  69.  
  70.  
  71. V E R B E S S E R U N G E N   u n d    E R W E I T E R U N G E N .
  72. __________________________________________________________________
  73.  
  74.  
  75.  
  76. Darstellung der Oberfläche.
  77. ---------------------------
  78.  
  79. Im  Gegensatz zu MENUX ist die Oberfläche meines  GFA-MENU-DELUXE  äste-
  80. thisch ansprechender gestaltet.  Alle Textausgaben sind blockweise orga-
  81. nisiert.  Die  Blocklänge richtet sich jeweils nach der längsten  Zeile. 
  82. Das  sieht auf einem dunklen Hintergrund schöner aus.  Die untere  Menu-
  83. seite dient als Titel.  Unten rechts bewegen sich Punkte,  welche stetig 
  84. eine  Punktzeile auf- und wieder abbauen.  Diese Spielerei hat  durchaus 
  85. auch  eine  praktische  Bedeutung:  Wenn ein  Programm  gestartet  wird, 
  86. welches  den Monitor nicht benötigt,  erkennt man am  Stillstand  dieser 
  87. Punkte,  dass  dieses  Programm  gerade aktiv  ist.  Wenn  ein  externes 
  88. Programm,  ausser Compiler und Linker gestartet wird,  kündigt sich dies 
  89. durch das Abdunkeln des Hintergrundmusters an.
  90.  
  91. Beim  Interpreterstart  werden die Directories für den  Interpreter  und 
  92. für  das GFA-File in zwei getrennten Zeilen während  des  Startvorganges 
  93. untereinander angezeigt. Das sieht besser aus und ist informativer.
  94.  
  95. Nach Rückkehr ins Menu wird ordnungsgemäss angezeigt,  wie lange welches 
  96. Programm ausgeführt wurde.  Im Gegensatz zu MENUX zeigt  GFA-MENU-DELUXE 
  97. alle  Zeitwerte in Stunden,  Minuten und Sekunden an,  denn es  ist  z.B 
  98. lästig  wenn  angezeigt wird,  dass man 10861  Sekunden  im  Interpreter 
  99. gearbeitet hat. Das sind 3h:01Min:01Sek....
  100.  
  101.  
  102.  
  103. Die File-Auswahl (^A oder F1).
  104. ------------------------------
  105.  
  106. Gemäss MENUX wählt man mit ^A oder F1 das zu bearbeitende GFA-File  aus. 
  107. Neu ist,  dass GFA-MENU-DELUXE erkennt, ob wirklich ein GFA-File gewählt 
  108. wurde. Wenn nicht, wird dies mittels ALERT-Box beanstandet.
  109.  
  110. Eine wesentliche Erneuerung ist,  dass GFA-MENU-DELUXE der Fileparameter 
  111. der  BASEPAGE  auswertet.  Daher  kann GFA-MENU-DELUXE  auch  von  einem 
  112. Zeilenkommandointerpreter wie GULAM,  mit zu bearbeitendem GFA-File  als 
  113. Parameter  gestartet  werden.  Es werden als  Parameter  absoluter-  und 
  114. relativer Pfad in Vorwärtsrichtung akzeptiert. Das bedeutet, dass Einga-
  115. ben wie ..\..\ falsch verarbeitet werden.
  116.  
  117. Bevor  man aus einem Zeilenkommandointerpreter GFA-MENU-DELUXE  startet, 
  118. muss  vorher  mittels  "cd" der Pfad eingestellt  werden,  in  dem  sich 
  119. MENUDLX.PRG befindet,  sonst kann die Filesystemdatei MENUDLX.DAT  nicht 
  120. gefunden werden.
  121.  
  122. Falls  Sie im Genuss der GEMINI-Shell sind,  können Sie wie gewohnt  ein 
  123. GFA-File  mit  der  Maus packen und über  GFA-MENU-DELUXE  schieben  und 
  124. schon  startet  dieses Menu mit dem GFA-File.  Luxuriöses geht  es  kaum 
  125. noch.
  126.  
  127.  
  128.  
  129. Compiler-, Interpreter-, Linkerstart, Start des RCS und des 'Test'.
  130. -------------------------------------------------------------------
  131.  
  132. Diese Operationen entsprechen denen des MENUX,  wurden jedoch je um eine 
  133. Fehlererkennung  mittels ALERT-Box erweitert.  Es wird  mitgeteilt  wenn 
  134. das  aufgerufene  Programm  wegen Nichterkennung  des  Pfades  oder  des 
  135. Programmnamens nicht gestartet werden kann.
  136.  
  137. Beim  Interpreteraufruf  ist  der Pfad des  ausgewählten  GFA-Files  als 
  138. gültiger  Pfad gesetzt.  Dies hat den Vorteil,  dass auch GFA-Files  mit 
  139. ihren zu lesenden Dateien in einem andern Pfad korrekt mit dem Interpre-
  140. ter  getestet  werden  können.  Dies ist  in  MENUX  wegen  fehlerhafter 
  141. Programmierung, nicht möglich!
  142.  
  143.  
  144.  
  145. Das Starten fremder Programme  EXECUTE ^X.
  146. ------------------------------------------
  147.  
  148. Diese  Funktion  gibt es zwar in MENUX,  jedoch  konnte  man  ausserhalb 
  149. dessen Pfades keine Programme starten,  welche seinerseits Dateien lesen 
  150. mussten.  Dieses Problem ist in GFA-MENU-DELUXE gelöst:  Vor jedem frem-
  151. dem Programmstart wird der richtige Pfad gesetzt.  Bei der Rückkehr  ins 
  152. GFA-MENU-DELUXE wird ebenfalls wieder der korrekte Pfad gesetzt.
  153.  
  154.  
  155.  
  156. Sets: C-Objekt C.
  157. -----------------
  158.  
  159. Es gilt was in README.COM steht.  Nur steht dort längst nicht alles, was 
  160. diese  Option bereits im MENUX konnte und im GFA-MENU-DELUXE  selbstver-
  161. ständlich immer noch kann:
  162.  
  163.   Bei der Eingabe des compilierten C-Files, also eines O-Files, wird die 
  164.   Extension ".O" nicht angegeben, da diese automatisch gesetzt wird.
  165.  
  166.   Es  können auch mehrere O-Files eingegeben werden,  welche dann  durch 
  167.   Leerzeichen von einander zu trennen sind.
  168.  
  169.   Bei der Eingabe der O-Files,  muss der korrekte Pfad natürlich mitein-
  170.   gegeben werden.  Es genügt jedoch die Eingabe des relativen Pfades  in 
  171.   Vorwärts- und Rückwärtsrichtung (..\).
  172.  
  173. Neu  ist in GFA-MENU-DELUXE,  dass nach dem Linkvorgang zusätzlich  mit-
  174. tels ALERT-Box die Anzahl undefinierter Symbole und Offsetüberschreitun-
  175. gen angezeigt werden.
  176.  
  177. Wenn  ein C-File-Name oder dessen Pfad falsch eingeben wurde,  oder  der 
  178. Linker nicht ansprechbar ist,  folgt ebenfalls eine geeignete Fehlermel-
  179. dung mittels ALERT-Box.
  180.  
  181.  
  182.  
  183. Sets: PRG=GFA.
  184. --------------
  185.  
  186. Der  Ordnung zu liebe,  landen alle compilierten GFA-Programme in  einem 
  187. Ordner namens COMPILAT (TEST.PRG).  Im PRG=GFA-Mode jedoch wie bisher im 
  188. selben  Pfad wo sich das zu bearbeitende  GFA-File  befindet.  Existiert 
  189. beim  Compiler-  oder  Linkerstart bereits der  Name  des  PRG-Files  im 
  190. selben Pfad,  fragt eine ALERT-Box,  ob man wirklich das bestehende PRG-
  191. File überschreiben möchte.
  192.  
  193. Ist die Option PRG=GFA aktiv,  wird dies neuerdings ständig im  Menubal-
  194. ken dem Programmierer mitgeteilt.  Dies hat den Vorteil,  dass man diese 
  195. Option nicht immer wieder im Klappmenue nachschauen muss.  Nur wenn  der 
  196. TEST.PRG-Mode (Ordner:  Compilat) aktiv ist,  ist es gestattet, den Pfad 
  197. zu editieren <P>.  Im PRG=GFA-Mode erfolgt beim Editierversuch <P>  eine 
  198. ALERT-Box mit dem Hinweis, dass man sich im Widerspruch befindet.
  199.  
  200.  
  201.  
  202.  
  203. E x t r a s.
  204. ------------
  205.  
  206. Dies  ist  in GFA-MENU-DELUXE absolut neu!  Mit  Hilfe  dieses  "Extras" 
  207. können zusätzlich nützliche Programme und Funktionen direkt ohne Filese-
  208. lectorbox aufgerufen werden,  welche dem Programmierer das Leben zusätz-
  209. lich erleitern. Weshalb, erfahren Sie gleich im Detail.
  210.  
  211.  
  212.  
  213. Extras:  Editor ^E.
  214. -------------------
  215.  
  216. Ein zusätzlicher Editor aufrufen, wozu?
  217.  
  218.   Man  kann  zwei LST-Files vergleichen,  oder von  einem  LST-File  ins 
  219.   andere, Blöcke übertragen. 
  220.  
  221.   Möchte  man  ein  zu einem gerade  bearbeitendem  GFA-File  gehörendes 
  222.   Datenfile  editieren,  so erledigt man dies rasch und bequem  mit  dem 
  223.   zusätzlichen Editoraufruf.
  224.  
  225.   Man kann zum Beispiel ein LST-File und C-File  gegenüberstellen.  Dies 
  226.   ist  besonders  interessant im Hinblick auf  die  kommenden  GFA-TO-C-
  227.   CONVERTER...  
  228.  
  229.   Man kann... , Sie haben vielleicht noch weitere Ideen!
  230.  
  231.  
  232. Welcher Editor kommt in Frage?
  233.  
  234.   Als  Editor eignet sich z.B.  TEMPUS (per Default  in  GFA-MENU-DELUXE 
  235.   MENUDLX.DAT programmiert).  Es muss in jedem Fall ein Editor sein, mit 
  236.   dem man mindestens zwei Files bearbeiten kann. 
  237.  
  238.  
  239. Spezielle Funktion beim Editor-Aufruf:
  240.   
  241.   Hat man vor dem Editoraufruf ^E bereits ein GFA-File ausgewählt  (^A), 
  242.   jedoch  ein  gleichnamiges LST-File existiert im  selben  Pfad  nicht, 
  243.   erscheint eine ALERT-Box und meldet,  dass man noch kein gleichnamiges 
  244.   LST-File  erzeugt  hat.  Man  hat nun  die  Wahl,  weiter  zum  Editor 
  245.   "durchzustarten"  oder  man geht zurück über  GFA-MENU-DELUXE  in  den 
  246.   Interpreter um noch das gleichnamige LST-File zu erzeugen.  Bei  noch-
  247.   maligem  Editoraufruf wird nun das LST-File als Parameter  zum  Editor 
  248.   übertragen.  Danach kann man noch zusätzliche Files laden,  im  TEMPUS 
  249.   maximal noch drei.
  250.  
  251.  
  252.  
  253. Extras:  Finder ^F.
  254. -------------------
  255.  
  256. Dies ist ein komfortabler mausgesteuerter PD-File-Finder.  Welcher  Pro-
  257. grammierer  war nicht auch schon in der Situation,  während  der  Arbeit 
  258. irgendwo nach einem GFA-File oder LST-File zum Mergen suchen zu müssen?
  259.  
  260.  
  261.  
  262. Extras:  GULAM ^G.
  263. ------------------
  264.  
  265. Dies  ist ein UNIX-naher  Zeilenkommandointerpreter.  Eine  ausführliche 
  266. Dokumentaion  liegt  bei.  Der Sinn der Integration  in   "Extras"  ist, 
  267. kompilierte  GFA-Programme mit  BASEPAGE-Parameterübernahme  (z.B.  TTP-
  268. Programme) gleich nach dem Übersetzen zu testen.
  269.  
  270.  
  271.  
  272. Extras:  Filesystem.
  273. --------------------
  274.  
  275. Diese  Funktion  gibt dem GFA-Programmierer Auskunft über  den  gültigen 
  276. Pfad und darüber wo die veschiedenen Programme zu Hause sind.
  277.  
  278.  
  279.  
  280. Extras: UNDO (Bild).
  281. --------------------
  282.  
  283. Dies  bewirkt gleich wie die Taste <UNDO>  die  Bildregenaration.  Diese 
  284. Funktion wird vor allem nach Benutzung von Accessories benötigt.
  285.  
  286.  
  287.  
  288. Das File-System.
  289. ----------------
  290.  
  291. Beim Start des GFA-MENU-DELUXE liest das Programm die Datei  MENUDLX.DAT 
  292. und übernimmt das dort enthaltene Filesystem. Die nachfolgende Wiederga-
  293. be  dieses MENUDLX.DAT ist nur ein Beispiel.  Der Benutzer ist  frei  in 
  294. der  Gestaltung.  Wichtig ist jedoch,  der Pfad des GFA-MENU-DELUXE  ist 
  295. Referenz.
  296.     
  297.        GFA_3.PRG                   (GFA-BASIC-Interpreter, umbenannt)
  298.        COMPLINK\GFA_BCOM.PRG       (GFA-BASIC-Compiler)
  299.        COMPLINK\GL.PRG             (GFA-BASIC-Linker)
  300.        RCS2.PRG                    (Resource-Constr.-Set von GFA)
  301.        D:\TEMPUS\TEMPUS.PRG        (Zusätzlicher Editor)
  302.        C:\BIN\QUIKFIND.PRG         (File-Finder)
  303.        C:\BIN\GULAM.PRG            (UNIX-nahe Shell)
  304.        COMPILAT\TEST.O             (Defaultpfad des TEST.O-Files)
  305.        COMPILAT\TEST.PRG           (Defaultpfad des Compilates)
  306.        COMPLINK\GFA3BLIB           (Original-GFA-Bibliothek)
  307.  
  308. Wichtig:  Kommentare  wie oben im Beispiel dürfen im  MENUDLX.DAT  nicht 
  309.           stehen!
  310.  
  311. Das oben dargestellte Beispiel des MENUDLX.DAT zeigt relative  Vorwärts-
  312. pfade.  Auf  der ersten Ebene muss das GFA-MENU-DELUXE  MENUDLX.PRG  und 
  313. MENUDLX.DAT  platziert  sein.  Dies illustriert als  Beispiel  folgendes 
  314. "File-System":
  315.  
  316. E:\  GFA_BAS._V3 \ MENUDLX.PRG               (GFA-MENU-DELUXE)
  317.                  \ MENUDLX.DAT
  318.  
  319.                  \ AT_WORK  \ ...            (GFA-Files in Arbeit)
  320.  
  321.                  \ COMPILAT \ (TEST.PRG)     (Defaultpfad des Compilates)
  322.                               (TEST.O)       (Defaultpfad von TEST.O)
  323.  
  324.                  \ COMPLINK \ GFA_BCOM.PRG   (GFA-BASIC-Compiler)
  325.                               GL.PRG         (GFA-BASIC-Linker)
  326.                               GFA3BLIB       (Original-GFA-Bibliothek)
  327.                               GFA3BLIB.NDX
  328.  
  329.                  \ GFA_3.PRG                 (GFA-BASIC-Interpreter)
  330.                  \ RCS2.PRG                  (GFA-Resource-Constr.-Set)
  331.                  \ RCS2.DFN
  332.                  \ RCS2.RSC
  333.  
  334. C:\  BIN         \ GULAM.PRG                 (UNIX-nahe Shell)
  335.                  \ GULAM.G                   (braucht GULAM.PRG)
  336.                  \ GULAM.HLP                 (braucht GULAM.PRG)
  337.  
  338.                  \ QUIKFIND.PRG              (File-Finder)
  339.  
  340.           
  341. D:\  TEMPUS      \ TEMPUS.PRG                (Zusätzlicher Editor)
  342.  
  343.  
  344. An  Stelle der Partition E einer Harddisk,  kann selbstverstädlich  auch 
  345. eine andere Partition gewählt werden.  Das selbe gilt für den  Hauptord-
  346. ner  "GFA_BAS._V3".  Man kann diesen Ordner anders  benennen,  oder  was 
  347. aber  der Ordnung zu liebe,  weniger zu empfehlen ist,  ganz  weglassen. 
  348. Die  Pfade der Programme welche nicht Teil  des  GFA-BASIC-Entwicklungs-
  349. packetes  sind,  dürfen auch ganz wo anders installiert und  dementspre-
  350. chend in MENUDLX.DAT vermerkt werden.
  351.  
  352.  
  353.  
  354.  
  355.  
  356. Welche Programme und Dateien befinden sich wo auf der Diskette?
  357. ---------------------------------------------------------------     
  358.  
  359.  
  360. MENUDLX   \ GFA_BAS._V3  \ MENUDLX.PRG  (GFA-MENU-DELUXE)
  361.                            MENUDLX.DAT  (zugehöriges Filesystem)
  362.  
  363.           \ BIN          \ GULAM.PRG    (PD-UNIX-nahe Shell.)
  364.                          \ GULAM.G      (Daten, Alias etc.)
  365.                          \ GULAM.HLP    (Help-File für GULAM.)
  366.                          \ GULAM.DOC    (Sehr ausführliches Manual.)
  367.  
  368.                          \ QUIKFIND.PRG (PD-File-Finder)
  369.  
  370.           \ QUELLTXT     \ MENUDLX.GFA  (GFA-Quelltext)
  371.                          \ MENUDLX.LST  (LST-Quelltext)
  372.                          \ MENUDLX.INL  (Inline-Maschinencode)
  373.  
  374.           \ DOKUMENT     \ MENUDLX.INF  (Dieses Dokument als ASCII.)
  375.                            MENUDLX.DOC  (Dieses Dokument als Wordplus.)
  376.  
  377.  
  378.  
  379. Wie Sie feststellen,  ist der in GFA-MENU-DELUXE verwendete  zusätzliche 
  380. Editor TEMPUS nicht auf der Diskette.  Der Grund ist,  dass TEMPUS weder 
  381. ein Public-Domain- noch ein Share-Ware-Programm ist.  Es ist aber  jedem 
  382. GFA-3.x-BASIC-Programmierer freigestellt, seinen Liebliongseditor kombi-
  383. niert mit GFA-MENU-DELUXE einzusetzen.  Man darf aber dann nicht verges-
  384. sen, MENUDLX.DAT entsprechend anzupassen.
  385.  
  386. Die  andern  beiliegenden Programme wie GULAM und QUIKFIND  dürfen  frei 
  387. kopiert werden, da diese PDs sind.
  388.  
  389.  
  390.  
  391. Ich  wünsche  Ihnen ungetrübte Programmierstunden mit  GFA-3.x-BASIC  in 
  392. Symbiose mit meinem GFA-MENU-DELUXE....
  393.  
  394.  
  395.  
  396.                                        Th. Schaerer  01-nov-91
  397.  
  398.